<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta http-equiv="Content-Language" content="zh-CN"><title>systemd-cat
  中文手册 [金步国]</title><style>
@font-face { font-family: "JinBuGuoWebMono"; src: url("http://www.jinbuguo.com/d/mono.ttf") format("truetype"); }
* { font-family: "JinBuGuoWebMono", "Ubuntu Mono", "Consolas", "Menlo", monospace; }
body { margin:10px; }
h1 { text-align:center; background:#ddd; }
h2#auth_name { text-align:center; margin: 10px 5%; }

    a.headerlink {
      color: #c60f0f;
      font-size: 0.8em;
      padding: 0 4px 0 4px;
      text-decoration: none;
      visibility: hidden;
    }

    a.headerlink:hover {
      background-color: #c60f0f;
      color: white;
    }

    h1:hover > a.headerlink, h2:hover > a.headerlink, h3:hover > a.headerlink, dt:hover > a.headerlink {
      visibility: visible;
    }
</style><script> var _hmt = _hmt || []; (function() { var hm = document.createElement("script"); hm.src = "https://hm.baidu.com/hm.js?d286c55b63a3c54a1e43d10d4c203e75"; var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(hm, s); })(); </script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><h1>systemd-cat 中文手册</h1><h2 id="auth_name">译者：<strong><a href="../index.html">金步国</a></strong></h2><hr><h3>版权声明</h3><p>本文译者是一位开源理念的坚定支持者，所以本文虽然不是软件，但是遵照开源的精神发布。</p><ul><li>无担保：本文译者不保证译文内容准确无误，亦不承担任何由于使用此文档所导致的损失。</li><li>自由使用：任何人都可以自由的<u>阅读/链接/打印</u>此文档，无需任何附加条件。</li><li>名誉权：任何人都可以自由的<u>转载/引用/再创作</u>此文档，但必须保留译者署名并注明出处。</li></ul><h3>其他作品</h3><p>本文译者十分愿意与他人分享劳动成果，如果你对我的其他翻译作品或者技术文章有兴趣，可以在如下位置查看现有的作品集：</p><ul><li><a href="../index.html">金步国作品集</a> [ <a href="../index.html">http://www.jinbuguo.com/</a> ]</li></ul><h3>联系方式</h3><p>由于译者水平有限，因此不能保证译文内容准确无误。如果你发现了译文中的错误(哪怕是错别字也好)，请来信指出，任何提高译文质量的建议我都将虚心接纳。</p><ul><li>Email(QQ)：70171448在QQ邮箱</li></ul><hr><a href="systemd.index.html">手册索引</a> ·
  <a href="systemd.directives.html">指令索引</a><span style="float:right">systemd-241</span><hr><div class="refentry"><a name="systemd-cat"></a><div class="titlepage"></div><div class="refnamediv"><h2>名称</h2><p>systemd-cat — 通向系统日志的管道</p></div><div class="refsynopsisdiv"><h2>大纲</h2><div class="cmdsynopsis"><p><code class="command">systemd-cat [OPTIONS...]  [COMMAND]  [ARGUMENTS...]</code> </p></div><div class="cmdsynopsis"><p><code class="command">systemd-cat [OPTIONS...]</code> </p></div></div><div class="refsect1"><a name="id-1.5"></a><h2 id="描述">描述<a class="headerlink" title="Permalink to this headline" href="systemd-cat.html#%E6%8F%8F%E8%BF%B0">¶</a></h2><p><span class="command"><strong>systemd-cat</strong></span> 可以将标准输入重定向到系统日志中，
    也可以将进程的标准输出与标准错误重定向到系统日志中，
    还可以用作管道过滤器，
    将捕获的其他进程的标准输出重定向到系统日志中。</p><p>如果未指定任何 [COMMAND] 参数，那么 <span class="command"><strong>systemd-cat</strong></span>
    将会把它从标准输入读取到的所有内容
    重定向到系统日志中。</p><p>如果传递了 [COMMAND] 参数，
    那么将会把  [COMMAND]
    进程的标准输出与标准错误
    重定向到系统日志中。</p></div><div class="refsect1"><a name="id-1.6"></a><h2 id="选项">选项<a class="headerlink" title="Permalink to this headline" href="systemd-cat.html#%E9%80%89%E9%A1%B9">¶</a></h2><p>能够识别的命令行选项如下：</p><div class="variablelist"><dl class="variablelist"><dt id="-h"><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span><a class="headerlink" title="Permalink to this term" href="systemd-cat.html#-h">¶</a></dt><dd><p><a name="help-text"></a>显示简短的帮助信息并退出。
    </p></dd><dt id="--version"><span class="term"><code class="option">--version</code></span><a class="headerlink" title="Permalink to this term" href="systemd-cat.html#--version">¶</a></dt><dd><p><a name="version-text"></a>显示简短的版本信息并退出。</p></dd><dt id="-t"><span class="term"><code class="option">-t</code>, </span><span class="term"><code class="option">--identifier=</code></span><a class="headerlink" title="Permalink to this term" href="systemd-cat.html#-t">¶</a></dt><dd><p>设置一个短字符串，
        用作日志的来源标志。
        默认值是"unknown"。</p></dd><dt id="-p"><span class="term"><code class="option">-p</code>, </span><span class="term"><code class="option">--priority=</code></span><a class="headerlink" title="Permalink to this term" href="systemd-cat.html#-p">¶</a></dt><dd><p>指定日志消息的默认日志等级。
        可设为
        "<code class="literal">emerg</code>",
        "<code class="literal">alert</code>",
        "<code class="literal">crit</code>",
        "<code class="literal">err</code>",
        "<code class="literal">warning</code>",
        "<code class="literal">notice</code>",
        "<code class="literal">info</code>",
        "<code class="literal">debug</code>" 之一，
        或者与上述日志等级对应的 0 到 7 之间的整数。
        详见
        <a href="http://man7.org/linux/man-pages/man3/syslog.3.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a> 手册。
        默认值是 "<code class="literal">info</code>" 等级。
        注意，此选项仅设置默认的日志等级，
        通过开启 <code class="option">--level-prefix=</code> 选项，
        某些特定的行可以使用不同的日志等级。</p></dd><dt id="--stderr-priority="><span class="term"><code class="option">--stderr-priority=</code></span><a class="headerlink" title="Permalink to this term" href="systemd-cat.html#--stderr-priority=">¶</a></dt><dd><p>进程发送到标准错误(stderr)的消息的
        默认日志等级。
        此选项的用法与上文的
        <code class="option">--priority=</code> 选项相同。
        当与 <code class="option">--priority=</code> 一起使用时，
         <code class="option">--priority=</code> 将只作用于标准输出(stdout)。
        </p><p>如果未使用此选项，
        那么来自标准错误(stderr)的消息仍将被记录，
        但其日志等级将与标准输出(stdout)相同。</p><p>当标准输出(stdout)与标准错误(stderr)使用相同的默认日志等级时，
        消息将被严格排序，因为两者都使用同一个通道。
        当默认日志等级不同时，
        分别使用两个信道，
        标准输出(stdout)消息并不会严格按照标准错误(stderr)消息排序
        (尽管两者趋向于近似排序)</p></dd><dt id="--level-prefix="><span class="term"><code class="option">--level-prefix=</code></span><a class="headerlink" title="Permalink to this term" href="systemd-cat.html#--level-prefix=">¶</a></dt><dd><p>是否解析传统的 syslog 日志等级前缀。
        必须指定为一个布尔值。
        默认值"yes"表示遵守传统的 syslog 日志等级前缀习惯。
        例如，一条以 "<code class="literal">&lt;5&gt;</code>" 开头的日志
        表示其日志等级为 5("<code class="literal">notice</code>")。
        其他以此类推。</p></dd></dl></div></div><div class="refsect1"><a name="id-1.7"></a><h2 id="退出状态">退出状态<a class="headerlink" title="Permalink to this headline" href="systemd-cat.html#%E9%80%80%E5%87%BA%E7%8A%B6%E6%80%81">¶</a></h2><p>返回值为 0 表示成功，
    非零返回值表示失败代码。</p></div><div class="refsect1"><a name="id-1.8"></a><h2 id="例子">例子<a class="headerlink" title="Permalink to this headline" href="systemd-cat.html#%E4%BE%8B%E5%AD%90">¶</a></h2><div class="example"><a name="id-1.8.2"></a><p class="title"><b>例 1. 调用一个程序</b></p><div class="example-contents"><p>调用 <code class="filename">/bin/ls</code>
      程序，并将其标准输出与标准错误重定向到系统日志中。</p><pre class="programlisting"># systemd-cat ls</pre></div></div><br class="example-break"><div class="example"><a name="id-1.8.3"></a><p class="title"><b>例 2. 用作一个管道</b></p><div class="example-contents"><p>接收
      <code class="filename">/bin/ls</code> 的标准输出，
      并将其重定向到系统日志中。</p><pre class="programlisting"># ls | systemd-cat</pre></div></div><br class="example-break"><p>虽然上述两个例子的最终效果差不多，
    但是首选使用前一种方法，因为同一时间仅需要运行一个进程，
    并且可以同时捕获 stdout 与 stderr 的内容，
    而第二种方法只能捕获 stdout 的内容。</p></div><div class="refsect1"><a name="id-1.9"></a><h2 id="参见">参见<a class="headerlink" title="Permalink to this headline" href="systemd-cat.html#%E5%8F%82%E8%A7%81">¶</a></h2><p>
      <a href="systemd.html#"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
      <a href="systemctl.html#"><span class="citerefentry"><span class="refentrytitle">systemctl</span>(1)</span></a>,
      <a href="http://man7.org/linux/man-pages/man1/logger.1.html"><span class="citerefentry"><span class="refentrytitle">logger</span>(1)</span></a>
    </p></div></div></body></html>
